Skip to main content
Duet is accessed entirely through SSH. No installation or downloads required - just connect using your terminal’s SSH client.

​
Hosted Version

Connect to the hosted instance of Duet:
Replace <username> with your desired username. This will identify you in pairing sessions.

​
Local Development

If you’re running Duet locally for development:
1

Start the server

Run the development environment:
This starts the SSH server on port 2222 and the Cloudflare worker locally.
2

Connect via SSH

Connect to your local instance:

​
Server Configuration

When running your own Duet server, you can configure it using command-line flags (see main.go:12-14):
  • --addr - SSH server address (default: :2222)
  • --hostkey - Path to SSH host key (default: .ssh/id_ed25519)
  • --worker - Duet CF Worker base URL for AI features
Example:

​
After Connecting

Once connected, you’ll see the launch screen where you can:
  • Create a new pairing room
  • Join an existing room
See Creating Rooms for next steps.

​
Troubleshooting

​
Connection Refused

If you get “Connection refused”:
  • Verify the server is running
  • Check the port number (2222 for local, 22 for hosted)
  • Ensure your firewall allows outbound SSH connections

​
Authentication Failed

Duet uses SSH key authentication. Ensure:
  • Your SSH client is configured with valid keys
  • The server has a valid host key at the configured path

​
Username Issues

If you don’t specify a username, Duet will assign you the default username “guest” (see internal/ui/model.go:85-87).